home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 031a / dvtman11.zip / DVTMAN.DOC < prev    next >
Text File  |  1990-07-09  |  12KB  |  266 lines
  1.  
  2.                              DV Task Manager
  3.  
  4.         DV Task Manager is intended to provide DESQview users running
  5. real-time systems a powerful and consistent method of automating
  6. DESQview window operations during unattended operations.  Because DV
  7. Task Manager requires the services of DVTXDI.COM, the following note
  8. is of supreme importance:
  9.  
  10. ***************    Important!  Important!  Important!    *****************
  11. You must be running DESQview version 2.26 or higher for this program to be
  12.         of value!  (Meaning, in 2.25, it won't do anything).
  13. **************************************************************************
  14.  
  15. Summary of Features:
  16.  
  17.    *  DV Task Manager runs comfortably in a non-swappable 30K DESQview
  18.         window and utilizes DESQview API functions to monitor the system
  19.         timer and schedule pending events.
  20.  
  21.    *  Any program for which the user has created a DESQview PIF (by
  22.         adding to the DESQview Open Window menu or otherwise), may be
  23.         run as an event.
  24.  
  25.    *  Events may be scheduled by time of day or by timed interval.  Any
  26.         event may be 'masked off' for particular days of the week.
  27.  
  28.    *  Since the host DV version must be 2.26 or greater, events may be
  29.         run in the background and/or hidden.
  30.  
  31.    *  In addition to PIF style program initiation, an event may also
  32.         request windows be closed in a variety of ways.
  33.  
  34.  
  35.         DV Task Manager was written using Turbo Professional (Borland Intl).
  36. DESQview interface functions are courtesy of Ralf Brown and his DVGLUE API
  37. library.  Credit also goes to Robert Jourdain for his C Express Programmer's
  38. Library (1989, Simon & Schuster).
  39.     DESQview is a trademark of Quarterdeck Office Systems.
  40.         DVTMAN.COM and all supporting materials are (c)1990 Michael D. Weaver.
  41. All rights are reserved.
  42.  
  43.  
  44.                                     Disclaimer
  45.  
  46.         This program is distributed AS IS - the author cannot accept for
  47. responsibility for the use or abuse of the program resulting in the loss of
  48. data or other imaginable damages.  Though the author is dedicated to
  49. DV Task Manager's correct operation and the support and implementation of
  50. enhancements requested by registered users, he's not rich and cannot
  51. therefore accept legal responsibility for the care and feeding of users' hard
  52. drives and/or other equipment.
  53.         The user of this program, in that he is expected to be the operator
  54. of an electronic bulletin board or other on-line, serious-use system, is
  55. expected to be aware of the potential problems running an unattended system
  56. entails.  Above all, automation implemented through the use of this program
  57. should be fully tested and monitored by the operator of the system prior
  58. to allowing its operation in an unattended environment.
  59.  
  60.  
  61.                                   About Shareware
  62.  
  63.         DV Task Manager is distributed as shareware.  What this means is that
  64. people who who find the program useful are encouraged to 'register' with the
  65. author for a nominal fee, in this case, $25.  Registration lets you feel good
  66. and gets you a fresh copy of the latest release of without the timed delay at
  67. program startup, and with an event maximum of 20 rather than three.  The
  68. $25 cost is for a single user license - businesses should inquire for
  69. information on site licenses.  All in all, if you use DESQview a lot, and you
  70. like DV Task Manager a lot, you should register if only to encourage the
  71. development of more DV-specific software in the future.
  72.     Registrations and all comments/inquiries should be addressed to:
  73.  
  74.     Michael D. Weaver
  75.     Box 4323
  76.     Danville, VA   24540
  77.  
  78.     Electronic contact addresses:
  79.  
  80.         MCI Mail        (MWEAVER)
  81.     FidoNET        (Mike Weaver - 1:264/610)
  82.  
  83.                                    Installation
  84.  
  85. 1)  Make sure that the target system is running DESQview version 2.26 or
  86.     higher.  This is extremely important as DV Task Manager will otherwise
  87.     be useless.
  88.  
  89. 2)  Install DVTXDI.COM as a TSR prior to starting DESQview.  This is best
  90.     accomplished in AUTOEXEC.BAT and may use a high-loading program such
  91.     as Quarterdeck's LOADHI.COM.  For additional information on DVTXDI.COM,
  92.     please refer to the file DVTXDI.DOC included in this archive.
  93.  
  94. 3)  Place the files DVTMAN.COM and TM-PIF.DVP in an appropriate directory
  95.     on the system's hard drive.  A good choice might be C:\DV\DVTMAN.
  96.  
  97. 4)  Use DESQview's Add a Program feature to install DV Task Manager
  98.     so that appears on DESQview's Open menu.  Refer to DESQview documentation
  99.     on Add a Program if necessary.
  100.  
  101. 5)  If your DESQview system does not reside in one of the following
  102.     directories, you will need to further customize the PIF using Change
  103.     a Program:
  104.  
  105.         C:\DV
  106.         D:\DV
  107.         E:\DV
  108.  
  109. 6)   DV Task Manager should now be available from the DV Open Menu.
  110.  
  111. IT IS HIGHLY RECOMMENDED THAT DV Task Manager ALWAYS BE STARTED AS THE
  112. FIRST WINDOW IN ANY DV SYSTEM (if possible).
  113.  
  114.  
  115.  
  116.                                Command Line Options
  117.  
  118. DV Task Manager recognizes the following options on its command line:
  119.  
  120. DVP=d:\fspec\dirname    -       DESQview directory, or more specifically,
  121.                                 the directory where DV Task Manager may
  122.                                 find the PIFs it will need to initiate
  123.                                 events.  Advanced users may wish to isolate
  124.                                 these PIFs in a special directory.
  125.  
  126. QUIET                   -       Requests silent operation.  Normally, DV
  127.                                 Task Manager will use beep sequences to
  128.                                 announce the initiation (or failed
  129.                                 initiation) of an event.
  130.  
  131.                                Program Operation
  132.  
  133. DV Task Manager's user interface consists of a single DESQview windows that
  134. the developer hopes will be easy to use and understand.  Each 'event'
  135. occupies a row, and the current event is displayed with fields unprotected
  136. for input.
  137.  
  138. Entering an event:
  139.  
  140.         The simplest way to enter an event for the first time is to
  141. key the appropriate 'DVP keys' or 'Open Keys' into the first unprotected
  142. field (??) and hit enter.  The remaining fields will be primed with default
  143. values.  To make the event active, tab to the start time or interval
  144. fields and key in the desired time.
  145.  
  146.  
  147. Event Status:
  148.  
  149.         Event status is shown at the start of each event line.  The
  150. next event scheduled will show an '*', and other pending events will
  151. show a small dot.  Events that have not been correctly entered will
  152. show neither.
  153.         Event status is modified in real-time as events are initiated
  154. and changes are made by the operator.
  155.         The appearance of a dot or asterisk DOES NOT ensure the event
  156. will run correctly.  No check is made to ensure that the requested PIF
  157. is available - this is learned only on event initiation.  In cases
  158. where the special actions field (see section below) is the major purpose
  159. of the event, the user can enter any invalid set of open keys and the
  160. special actions will still take place.
  161.         When an event is run, DV Task Manager 'rings' the system bell.
  162. One beep sounds if a PIF is found and started.  Two beeps sound if the
  163. event expires but a vaild PIF is not found.  These beeps may be suppressed
  164. with the QUIET command line option.
  165.  
  166.  
  167. Modifying an existing event (selecting a new current):
  168.  
  169.         Only one event (the 'current event') will have its fields
  170. ready for input at any given time.  Any other event (including the ??
  171. event which indicates an available slot) may be made the current
  172. event by moving the cursor, using arrows or the tab key, over the
  173. DVP keys field for the event and tapping the SPACE BAR.  All fields
  174. may then be modified.
  175.  
  176.  
  177. Deleting an event:
  178.  
  179.         Typing '--' into the DVP keys field of an event will delete
  180. that event from the display and DV Task Manager's event file.
  181.  
  182.  
  183.  
  184. Event Fields:
  185.  
  186. *  Start hh:mm   -  The time of day the event is to occur.  If the event
  187.                     is initiated by interval, these fields will show the
  188.                     time of the next expiration of the interval.
  189.  
  190. *  Intervl hh:mm -  The time in hours:minutes between iterations of the
  191.                     event.  The next scheduled expiration of the interval
  192.                     is shown in the start hh:mm fields.
  193.                     The first expiration is (re)calculated in the following
  194.                     instances:
  195.  
  196.                     -  When DV Task Manager initializes
  197.                     -  When the event is entered/modified
  198.  
  199.                     If nothing is entered into these fields they will show
  200.                     **:** and the event is assumed to be based on the time
  201.                     show in the start fields.
  202.  
  203. *  SMTWTFS       -  This is the day-of-week mask for the event.  Specific
  204.                     days can be masked off by an N or - (minus) character.
  205.                     If the event is interval based, the next expiration
  206.                     will be resheduled to 00:00 on the first day for
  207.                     which the event is again valid.  Default is to run
  208.                     event regardless of the day of the week.
  209.  
  210. *  BG            -  Y or N.  Specifies whether the event is to run in the
  211.                     background.  The default for this field is Y, but please
  212.                     note:  THE USER IS RESPONSIBLE for seeing that the
  213.                     PIF will indeed run in the background (that it has,
  214.                     for instance, RUNS IN BACKGROUND set to Y as shown on
  215.                     Add/Change a Program).
  216.  
  217. *  HD            -  Y or N.  Specifies whether the event is to run 'hidden'.
  218.                     Default is N.  Care should be taken in testing events
  219.                     for correct operation if this option is to be turned on.
  220.  
  221. *  Alt Program   -  If anything is present on this line it will be placed
  222.                     in the program field of the starting PIF.  This option
  223.                     is provided primarily to allow a single generic window
  224.                     to be used to run a variety of batch files without having
  225.                     to add each individually as separate DV windows.  This
  226.                     option is NOT RECOMMENDED for anyone unsure of what to
  227.                     use it for and how it will work.
  228.  
  229. *  Special...    -  Refer to the following page.
  230.  
  231.  
  232.  
  233. Special Actions field:
  234.  
  235. The Special Actions field provides a way of instructing DV Task Manager to
  236. do things other than start events.  These actions occur PRIOR TO an attempt
  237. to start the PIF associated with the event, and may in fact purposefully
  238. be associated with a PIF that does not exist (such as ** Open Keys).  With
  239. this release, the following special actions are available:
  240.  
  241. -+??    - where ?? indicates a specific set of open keys.
  242.           Action:  ALL windows running in DESQview that were started by
  243.           ?? open keys are closed prior to running the event.
  244.  
  245. -!??    - where ?? indicates a specific set of open keys.
  246.           Action:  ALL windows running in DESQview EXCEPT those started by
  247.           ?? open keys are closed prior to running the event.
  248.           The DV Task Manager window will not be affected.
  249.  
  250. -ALL    - where ?? indicates a specific set of open keys.
  251.           Action:  ALL windows running in DESQview are closed prior to
  252.           running the event.
  253.           The DV Task Manager window will not be affected.
  254.  
  255. NOTE!!! : Due to potential problems closing windows that are swapped to disk,
  256.           system lockups are possible if any of these commands are used to
  257.           close a window that is swapped to disk and cannot be remapped into
  258.           memory because a non-swappable window (such as DV Task Manager)
  259.           is in the way.  For this reason, DV Task Manager should always be
  260.           started as the first window in the system.
  261.  
  262. THESE FEATURES ARE HERE LABELED "Use at your own risk!"  THEY ARE INCLUDED
  263. FOR THEIR POTENTIAL VALUE, AND SHOULD BE USED ONLY AFTER CAREFUL TESTING
  264.                         BY THE SYSTEM OPERATOR.
  265.  
  266.